home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 173 (1991-09-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 173 (1991-09-10)(Manewaldt, A.)(DE)(PD).adf / BootPic / BootPic_Anleitung < prev    next >
Text File  |  1991-09-14  |  13KB  |  267 lines
  1.  
  2. *******************************************************************************
  3. *                                                                             *
  4. *                                 BootPicV1.1                                 *
  5. *                                                                             *
  6. *                         © 1991 by Andreas Ackermann                         *
  7. *                                                                             *
  8. *******************************************************************************
  9.  
  10. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  11. SHAREWARE-BEDINGUNGEN:
  12.  
  13.     BootPic ist SHAREWARE. BootPic darf nur unter folgenden Bedingungen weiter-
  14.     gegeben werden:
  15.  
  16.     o  BootPic darf nicht verändert sein
  17.     o  Dieses DOC-File muß mitkopiert werden
  18.     o  Es darf keine Gebühr erhoben werden (außer Aufwandsentschädigung fürs
  19.        kopieren, Disketten, etc.)
  20.  
  21.     Wenn Ihnen BootPic gefällt und Sie es öfters benutzen oder wenn Sie Teile
  22.     des Source-Codes in eigenen Programmen verwenden (z.B. die Fading-Routinen)
  23.     dann bitte ich um eine kleine Unterstützung in Höhe von ca. 5$ oder 5DM.
  24.  
  25.     Wollen Sie BootPic als Teil eines kommerziellen Programms verwenden,ist mei-
  26.     ne schriftliche Einwilligung erforderlich.
  27.  
  28.     Meine Adresse:         Andreas Ackermann
  29.                            Lorenz-Summa-Str.10
  30.                            W-8679 Oberkotzau
  31.                            Deutschland
  32.                            Tel.:09286/6399
  33.  
  34. ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­
  35. Bitte beachten Sie:
  36. Ich schrieb dieses Programm anstatt einen Ferienjob anzunehmen. Wenn ich auf
  37. diese Weise ein wenig Geld verdienen kann, werden weitere Programme und Updates
  38. folgen (z.B. Colorcycling, oder wie wär's mit einem Programm, das ein Library
  39. resetfest installiert [wäre hilfreich bei der ARP-Library].
  40.  
  41. INHALT:_________________________________________________________________________
  42.  
  43.  
  44.        1. Einleitung
  45.        2. Aufruf
  46.        3. Zum Parser
  47.        4. Kompatibilität
  48.        5. Was passiert nach einem Reset ?
  49.        6. Mögliche Fehlerquellen
  50.        7. Programmierung
  51.  
  52. ________________________________________________________________________________
  53.  
  54.  
  55.                               EINLEITUNG
  56.  
  57. Gehören Sie auch zu denjenigen Leuten, die die Workbenchhand, die nach jedem
  58. Reset erscheint, langweilig und einfallslos finden ?
  59. Dann ist dieses Programm genau das Richtige für sie. Mit BootPic können sie
  60. (fast) jedes IFF-ILBM-Bild anstelle der «Hand» laden. (Overscan,HAM,HalfBright,
  61. etc.) Es muß lediglich in komprimierter Form vorliegen, ansonsten wäre die Sache
  62. eine reine Speicherverschwendung. (Außer CraphiCraft speichern meines Wissens
  63. alle bekannten Programme ihre Bilder komprimiert,z.B. DPaint I,II,II)
  64. Das installierte Programm verbraucht ca. 1K mehr Speicher, als das IFF-File lang
  65. ist, wobei, falls vorhanden, Fast-Memory verwendet wird.
  66.  
  67.                                  AUFRUF
  68.  
  69. BootPic kann sowohl über die Workbench, als auch via CLI gestartet werden.
  70.  
  71. Wird BootPic von der Workbench aus gestartet, öffnet es ein Fenster mit drei
  72. Gadgets:
  73.  
  74.  Load Picture : Klicken sie dieses Gadget an, so erscheint ein Fenster mit einem
  75.                 Stringgadget, in welches sie den Namen eines IFF-Files eingeben
  76.                 können. Haben Sie sich's doch anders überlegt, können sie mit
  77.                 Cancel wieder zurück. Drücken sie jedoch RETURN, so versucht
  78.                 BootPic das angegebene Bild zu laden. Haben Sie die ARP-Library
  79.                 installiert, so verwendet BootPic den ARP-Filerequester.
  80.                 Wurde Bootpic mit der «erweiterten Auswahl» gestartet, d.h.
  81.                 Sie haben BootPic durch Halten der SHIFT-Taste zusammen mit
  82.                 einem anderen Icon activiert, so steht im Stringgadget des File-
  83.                 Requesters bereits der Name dieser Datei, so daß Sie, um diese
  84.                 zu laden, nur RETURN zu drücken brauchen.
  85.  Remove Picture :
  86.                 Entfernt ein etwaig installiertes Bild aus dem Speicher.
  87.  Info :         Gibt einen kurzen Info-Text aus.
  88.  
  89.  Die Farbe, zu der nach der Darstellung des Bildes ausgeblendet wird, entspricht
  90.  der Hintergrundfarbe des Bildschirms zum Zeitpunkt der Installation.
  91.  
  92.  Die möglichen Fehlermeldungen sind exakt die gleichen wie beim Start vom CLI.
  93.  
  94. BEISPIEL:
  95. ­­­­­­­­   Um das auf dieser Diskette mitgelieferte Demo-Bild zu installieren,
  96.            gehen Sie bitte folgendermaßen vor:
  97.            Öffnen Sie die BootPic-Schublade dieser Diskette. Klicken Sie einmal
  98.            auf das Icon «Demo.pic» und klicken sie nun 2x auf das Icon von
  99.            BootPic während Sie die SHIFT-Taste gedrückt halten.
  100.            Klicken Sie auf das Gadget «Load Picture» und anschließend RETURN.
  101.            Entfernen Sie nun eine etwaig eingelegte Disk in df0: und lösen einen
  102.            Reset aus. Wenn alles glatt ging können Sie nun das Demo-Bild be-
  103.            trachten.
  104.  
  105.  
  106. Beim Start vom CLI erfolgt die Steuerung wie üblich über CommandLine-Parameter.
  107. Jedoch wird, falls keine Parameter angegeben werden,  das oben beschriebene
  108. Fenster geöffnet.
  109.  
  110. Es gilt folgender Syntax:
  111.  
  112.                 BootPic -e | -l{IFF-File} [-s][-r][-c rgb]
  113.  
  114. -l{IFF-File}  Löscht, falls vorhanden, ein bereits installiertes Bild und ver-
  115.               sucht dann an dessen Stelle ein neues zu laden.
  116.  
  117.               Erfolgsmeldung:
  118.               «Picture successfully installed. Have Fun !»
  119.  
  120.               Mögliche Fehler:
  121.               «Couldn't open Picture-File»
  122.               BootPic konnte den angegebenen File nicht öffen (z.B. weil er
  123.               nicht vorhanden war)
  124.               «This is not an ILBM-Picturefile»
  125.               Der angegebene File war kein IFF-Bild.
  126.               «Picture is not compressed»
  127.               Das Bild war nicht komprimiert.[Es gibt Tools die unkomprimierte
  128.               Bilder konvertieren.]
  129.               «Warning:Couldn't find CAMG-Chunk»
  130.               CAMG-Chunk nicht gefunden: Hier ist der Viewmodus festgehalten
  131.               [z.B. Hires oder Interlace etc.]. Bis Kickstart V1.3 einschließ-
  132.               lich wird das Bild aber trotzdem korrekt dargestellt.
  133.               [AUSNAHME: statt des Halfbright-Modus wird der HAM-Modus einge-
  134.               schaltet]
  135.               «BODY-Chunk not found»
  136.               Das ILBM-File enthielt keine Bilddaten (sollte niemals vorkommen)
  137.               «Memlist corrupt. Something went totally wrong»
  138.               Bedeutung siehe bei -e
  139.               «Not enough Memory»
  140.               Der Speicher hat nicht ausgereicht.
  141.  
  142. -e            löscht, falls vorhanden, ein bereits installiertes Bild und gibt
  143.               den belegten Speicher frei.
  144.  
  145.               Erfolgsmeldung:
  146.               «Removed BootPic from List»
  147.  
  148.               Mögliche Fehler:
  149.               «BootPic not installed. Couldn't remove it»
  150.               Es war kein Bild geladen und somit konnte auch nichts gelöscht
  151.               werden.
  152.               «Memlist corrupt. Something went totally wrong»
  153.               BootPic hat zwar seinen Speicherbereich entdeckt, konnte aber sei-
  154.               nen Eintrag in der Resident-Tabelle nicht entdecken. (Sollte nie
  155.               passieren.) Falls diese Meldung erscheint, funktioniert entweder
  156.               BootPic fehlerhaft, oder ein anderes Programm, z.B. ein Virus, hat
  157.               sich an den Einsprungaddressen zu schaffen gemacht.
  158.  
  159.               Die folgenden Parameter funktionieren nur zusammen mit der -l
  160.               Option:
  161.  
  162. -s            lädt das unter -l angegebene Bild nur, falls noch kein Bild
  163.               installiert wurde. So ist es möglich, BootPic in der Startup-
  164.               -Sequence zu installieren.
  165.  
  166.               War bereits ein Bild installiert meldet sich BootPic so:
  167.               «BootPic already installed. Changed nothing.»
  168.  
  169. -r            BootPic führt nach dem Laden des Bildes ein Reset aus (nicht
  170.               notwendig)
  171.  
  172. -c            hier können Sie die Farbe angegeben, die nach dem Anzeigen des
  173.               Bildes eingeblendet werden soll. Normalerweise ist dies die Hin-
  174.               tergrundfarbe Ihres Workbench-Screens. Die Werte von r,g und
  175.               b müssen hexadezimal angegeben werden, also sind Werte von 0-9 und
  176.               A-F erlaubt, wobei 0 bedeutet, daß diese Komponente gar nicht und
  177.               F, daß sie mit maximaler Intensität vorhanden ist.
  178.               (z.B. -c000 für schwarz,-ce50 für orange). Andere Werte werden
  179.               zwar auch akzeptiert, aber dann ist das Resultat sicher nicht so
  180.               wie erwartet.
  181.               Voreingestellt ist 05a [Amiga-Blau].
  182.  
  183.  
  184.  
  185.                                 ZUM PARSER
  186.  
  187.  Alle Parameter können sowohl in Klein- als auch in Großschreibung angegeben
  188.  werden. Jeder Parameter MUSS mit einem «-» beginnen, die Reihenfolge der Pa-
  189.  rameter ist beliebig. Zwischen den einzelnen Parametern können beliebig viele
  190.  Leerzeichen stehen. Logischerweise müssen die Farbwerte nach -c stehen und
  191.  der Filename hinter -l.
  192.  Gültige Aufrufe wären z.B.:
  193.  
  194.   bootpic  -l  df0:meinbild -R   -c  7aB
  195.  
  196.   bootpic -E
  197.  
  198.   bootpic -cAE3  -S -ldf0:meinbild
  199.  
  200.  Wird -e oder -l nicht angegeben, oder stimmt sonst etwas nicht, gibt BootPic
  201.  den Syntax aus.
  202.  Werden -l und -e zusammen angegeben verhält sich BootPic so, als hätte man nur
  203.  -e angegeben.
  204.  
  205.                               KOMPATIBILITÄT
  206.  
  207.  BootPic installiert sich «schonend», d.h. möglicherweise schon vorher vorhande-
  208.  ne resetfeste Programme werden auch weiterhin ausgeführt, z.B. Guardian, CARD:,
  209.  aber auch Viren und sonstige Scherze.
  210.  Genau so sauber entfernt es sich auch wieder (sollte es zumindest).
  211.  
  212.                        WAS PASSIERT NACH EINEM RESET ?
  213.  
  214.  Haben sie BootPic erfolgreich installiert, wird, wannimmer sich nach dem Reset
  215.  keine bootfähige Diskette in DF0: befindet, die geladene Grafik weich einge-
  216.  blendet. Sobald sie eine bootfähige Diskette einlegen, gehen die Farben weich
  217.  in die unter -c angegebene Farbe über und Ihr System fährt wie gewohnt hoch.
  218.  [Das Ein-und Ausblenden von HAM-Bildern sieht ein wenig merkwürdig aus; hier-
  219.  zu wäre eine eigene Routine notwendig, wofür sich aber der Programmieraufwand
  220.  nicht lohnt.]
  221.  Wenn Sie während das Bild am Bildschirm ist die linke Maustaste drücken, er-
  222.  scheint die gewohnte Workbench-Hand. [z.B. hilfreich um zu überprüfen, ob
  223.  Guardian noch installiert ist.]
  224.  
  225.                            MÖGLICHE FEHLERQUELLEN
  226.  
  227.  Normalerweise bleibt ein einmal geladenes Bild solange im Speicher, bis Sie es
  228.  mit -e [Remove Picture] entfernen oder den Amiga ausschalten.
  229.  Allerdings gibt es einige Ausnahmen:
  230.  
  231.   a.)  Wenn Sie ein Programm benutzen, das meint der gesammte Speicher gehöre
  232.        ihm alleine (viele Spiele tun dies), kann es passieren, daß der von
  233.        BootPic reservierte Speicher überschrieben wird, und das Bild nicht mehr
  234.        erscheint.
  235.   b.)  Viele Viren überschreiben einfach die Resetvektoren. Dann bekommen Sie
  236.        Ihr Bild ebenfalls nicht mehr zu Gesicht.
  237.   c.)  Manche Viruskiller (z.B. ATool) sind der Meinung, alle Programme die re-
  238.        setfest sind, seien Viren (da macht BootPic keine Ausnahme).
  239.  
  240.  Sollte einer dieser drei Fälle eintreten, KANN es vorkommen, daß nach dem
  241.  Reset eine GURU-Meditation erscheint, die sich auch durch Drücken der linken
  242.  Maustaste nicht beseitigen läßt. In solchen Fällen hilft nur Ausschalten.
  243.  
  244.                                PROGRAMMIERUNG
  245.  
  246.  BootPic wurde zu 100% in Assembler verfaßt [Devpac2.14D] , daraus resultiert
  247.  auch die geringe Programmgröße von weniger als 9K.
  248.  Vielen Dank auch an JM Forgeas für den einmaligen Editor AZ V1.50.
  249.  
  250.  Die Version 1.1 unterscheidet sich von der V1.0 nur durch das Intuiton-
  251.  Interface, was 4K zusätzlichen Binärcode bedeutet. Aus diesem Grund habe ich
  252.  darauf verzichtet, den Sourcecode beizufügen. Für diejenigen, die BootPic
  253.  nur im CLI benutzen wollen, befindet befindet sich auf dieser Disk noch-
  254.  mals die Version 1.0, die ja schließlich nur halb so lang ist.
  255.  
  256.  Allerdings finde ich es ein wenig schade, daß ich bis heute [19.7.1991]
  257.  nicht mehr als 2x Post erhalten habe !
  258.  [Positiv: Es scheint keine BUGS zu geben.]
  259.  
  260.  BootPic läuft sowohl unter Kickstart Version 1.2 als auch 1.3. Leider war es
  261.  mir nicht möglich es unter Kickstart 2.0 zu testen.
  262.  Für Kritik, Lob, Anregungen und vorallem BUG-Reports bin ich sehr dankbar.
  263.  
  264.                          Viel Spaß wünscht Ihnen
  265.  
  266.   Oberkotzau, den 19.7.1991                      Andreas Ackermann [*10.07.1974]
  267.